Installation and Updates
There are three installation options to choose from:
With the NPM Package Manager you can easily install adaptor:ex from the command line on any common operating system and run it as an NPM application.
We recommend the Installation via NPM Package Manager if you want to use adaptor:ex locally on your computer or in an internal network.
A local installation allows you to use the ports on your computer. E.g. the serial port via USB or a sound card.
Especially for a server installation we recommend the Install in a Docker Container.
You can use our Docker Compose file to create a comprehensive and stable setup with independent server and client application and MongoDB integration.
The Server Setup tutorial will help you install adaptor:ex with Docker and Docker Compose on an external server, secure it, and make it accessible to everyone working on your project.
Download the adaptor:ex source code and use NPM to install and run the server application and client independently.
An install from source allows you to make changes to the software. We recommend installing from source if you want to customize some code or contribute to the development of adaptor:ex.
Notes
Command Line Terminal
To install adaptor:ex you currently have to use the command line of your operating system. Under macOS look for the program "Terminal". Under Linux you can find the terminal under the key combination [ctrl] + [alt] + [T]. Under windows look for the application "command prompt" or "commandline".
Configuration
The adaptor:ex server application offers several ways to customize your installation. The Readme of the adaptor:Ex server code repository describes all configuration options.
Some functions of the adaptor:ex server can also be controlled from the command line: Commands
Multi User Server Setup
Take a look at the Server Setup tutorial to install adaptor:ex with Docker and Docker Compose on an external server. Here you can also find out how to secure internet access to adaptor:ex and make it accessible to everyone working on your project.
Updates
We will frequently fix bugs, improve things (hopefully) and add new features in the future. Update via NPM or Docker every now and then to stay up to date.
Get help
Contact us if you are having trouble installing adaptor:ex. Write us at tech@machinaex.de or check out our Discord channel.
Install with NPM
Before you can proceed with the installation of adaptor:ex, you need the latest version of NodeJS. You can find the necessary installation files for your operating system here.
Once you have installed NodeJS, open your console or terminal and run the installation from the command line with npm
On macOS and Linux
On WindowsIf the installation was successful, start adaptor:ex with the command
You can find ways to configure adaptor:ex in the adaptor:ex server readme
To stop adaptor:ex server use the key combination [Ctrl] + [C] (windows/linux) or [Cmd] + [C] (MacOS), or type quit in the console.
Updates with NPM
Download the latest version of adaptor:ex by repeating the above installation.
With npm outdated -g you can check if a new version is available.
Installing with Docker
Download Docker for your operating system and follow the installation instructions at https://docs.docker.com/get-docker/
Create a new folder where you want to install adaptor:ex.
Open your command line, change to the adaptor:ex directory with the cd command and download the adaptor:ex docker-compose file:
curl -o docker-compose.yml https://gitlab.com/machina_ex/adaptor_ex/adaptor_ex_server/-/raw/main/docker-compose.yml
Execute the Docker Compose file:
adaptor:ex server, client, database and plugin extensions are downloaded and installed.
In the adaptor:ex server readme you can learn more about the configuration of adaptor:ex.
Updates with Docker
To update the adaptor:ex Docker installation change to the adaptor:ex directory. There execute the following commands:
and then
Installing from Source with NPM
Before you can proceed with the installation of adaptor:ex, you need the latest version of NodeJS. You can find the necessary installatios files for your operating system here.
Get adaptor:ex server and client:
server
Clone or download the current GitLab repository of the adaptor:ex server here: https://gitlab.com/machina_ex/adaptor_ex/adaptor_ex_server
Client
Clone or download the current GitLab repository of the adaptor:ex client here: https://gitlab.com/machina_ex/adaptor_ex/adaptor_ex_client
Now you can install the server and the client locally with NPM.
In the terminal (console) change to the directory where you have loaded or cloned the server or client.
or
If you are in the right directory run the following command:
If the installation was successful, start the adaptor:ex server in the corresponding directory with the command
Then, in a separate command line, start the adaptor:ex client in the appropriate directory with the command
Updates with git
Download the latest version of adaptor:ex server and client by updating the git repository in the respective directory with the following command
Restart the adaptor server and client.